home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / bbs_util / gifsee18.zip / GIFSEE.DOC < prev    next >
Text File  |  1994-06-22  |  17KB  |  404 lines

  1.  
  2.               ▄▄▄▄ ▄▄▄ ▄▄▄ ▄▄▄ ▄▄▄ ▄▄▄
  3.               █ ▄▄  █  █▄  █▄▄ █▄  █▄     Gif File Previewer
  4.               █▄▄█ ▄█▄ █   ▄▄█ █▄▄ █▄▄       Version 1.08
  5.  
  6.  
  7.        Copyrighted Pete Rocca & Multiboard Communications Center, 1994
  8.  
  9.  
  10. ╓───────────────────────────────────────────────────────────────────────────╖
  11. ║ GifSee 1.08                                                               ║
  12. ╙───────────────────────────────────────────────────────────────────────────╜
  13.  
  14.     A great utility that allows your users  to save  time by downloading
  15.     a collection of compressed GIF files instead of all the larger ones.
  16.  
  17.  
  18. ╓───────────────────────────────────────────────────────────────────────────╖
  19. ║ GifSee - What's new?                                                      ║
  20. ╙───────────────────────────────────────────────────────────────────────────╜
  21.  
  22.    Version 1.08
  23.  
  24.      ■  Can precompile CDROM lists for faster startup
  25.      ■  Chat program redraws screen after
  26.      ■  Support for upto 30 areas and staggered
  27.      ■  Few color changes
  28.      ■  Nicer log and configurable file name/location
  29.      ■  Pressing (N)ext, (P)revious when no more in that direction does
  30.         not redraw the screen
  31.  
  32.    Version 1.07
  33.  
  34.      ■  Support for multinode operation
  35.      ■  Creates unique working directories
  36.      ■  Support for local downloads
  37.      ■  Fixed a bug that caused data corruption if too many areas were defined
  38.      ■  Does an alphabetical sort of the file names
  39.      ■  Added a great utility that will silence the program
  40.      ■  Multiple configuration file support
  41.      ■  Better documentation
  42.      ■  Fixed stupid garbage display mistake with 1.04
  43.      ■  Fixed slow system display under OS/2 with SIO driver
  44.      ■  Allowed configurable GIFSEE.GIF in registered mode
  45.      ■  Allowed configurable help file
  46.  
  47. ╓───────────────────────────────────────────────────────────────────────────╖
  48. ║ GifSee - Configuration                                                    ║
  49. ╙───────────────────────────────────────────────────────────────────────────╜
  50.  
  51.     ■ GifSee is very easy to install.
  52.     ■ The configuration file format is displayed below...
  53.  
  54.         Line 1 : BBS Name
  55.         Line 2 : Sysop Name
  56.         Line 3 : Registration Number
  57.         Line 4 : Path/Name of DSZ program (Example C:\UTIL\DSZ.EXE)
  58.         Line 5+: Three types of codes:
  59.  
  60.                  @ = Filearea
  61.                      @File area description|file area path
  62.  
  63.                      eg) @General Files|c:\files\gifs
  64.                      eg) @Other GIFs|c:\files\gifother
  65.  
  66.                  * = Precompiled listing
  67.                      *File area description|precompiled file name
  68.  
  69.                      ex) *CDROM 1 Files|c:\files\gifsee\cdrom1.dat
  70.                      ex) *CDROM 2 Files|c:\files\gifsee\cdrom2.dat
  71.  
  72.                  $ = Logfile
  73.                      $log file name
  74.  
  75.                      ex) $c:\bbs\bbs.log
  76.                      ex) $c:\bbs\bbs*N.log
  77.  
  78.                       Note: placing a *N will translate to the
  79.                             current node number IF AND ONLY IF,
  80.                             you are using DOOR.SYS as your drop file.
  81.  
  82.  
  83.           (It's easier to look at the config file to catch on to this)
  84.  
  85.  
  86.     A couple of quick notes:
  87.  
  88.        1) This program can be run without any graphics being displayed
  89.           locally by setting an enviroment variable "SET GIFDESK=FILE"
  90.           in your batch file just before running GifSee.
  91.  
  92.           Example:
  93.                        @echo off
  94.                        cd \util\gifsee
  95.                        set GIFDESK=FILE
  96.                        GIFSEE \ra\door.sys
  97.  
  98.           I highly suggest the GIFDESK=FILE command, but remember you
  99.           should run a disk cache program if you are not already.
  100.  
  101.        2) This program WILL accept the DSZPORT redirection enviroment
  102.           variable. (see DSZ documentation for more information)
  103.  
  104.           Example:
  105.                        @echo off
  106.                        set gifdesk=file
  107.                        cd \ra\doors\gifsee
  108.                        if (%1) == (1) set DSZPORT=4
  109.                        if (%1) == (2) set DSZPORT=02f8,5
  110.                        if (%1) == (3) set DSZPORT=
  111.                        gifsee \ra\node%1\door.sys
  112.  
  113.           And I pass the node number to this batch file as it's only
  114.           parameter:  \ra\doors\GIFSEE.BAT <nodenumber>
  115.  
  116.  
  117.        3) The file GIFSEE.GIF _must_ be in the current directory along
  118.           will GifSee and GifDesk. (in unregistered mode)
  119.  
  120.        4) You can change the help file the GifSee displays by creating
  121.           a text file called GIFSEE.HLP in the same directory as the
  122.           GIFSEE.EXE file.
  123.  
  124.  
  125. ╓───────────────────────────────────────────────────────────────────────────╖
  126. ║ GifSee - Running                                                          ║
  127. ╙───────────────────────────────────────────────────────────────────────────╜
  128.  
  129.  
  130.     -TWO- options...
  131.  
  132.     1) The GifSee  program must be run in the same directory as GIFSEE.CFG
  133.        and GIFDESK.EXE and must be called with one parameter, which is the
  134.        drop file.
  135.  
  136.        Example  ══  \gifsee\GIFSEE.EXE \bbs\DORINFO1.DEF
  137.  
  138.     2) The GifSee program must be run in the same directory as GIFDESK.EXE
  139.        and must  be called with  two parameters, the  first being the drop
  140.        file and the second  being the path\name of the configuration file.
  141.        This allows you to define multiple configurations depending on your
  142.        security setups, etc.
  143.  
  144.        Example  ══  \gifsee\GIFSEE.EXE \bbs\DOOR.SYS \gifsee\ADULT.CFG
  145.  
  146.        (With this way, you can have multiple menu entries that can be
  147.         accessed by users with certain age/security settings)
  148.  
  149.     Valid drop file formats are  EXITINFO.BBS (type 2+ only),  DOOR.SYS,
  150.     DORINFO?.DEF.
  151.  
  152.     (altough, if running TriBBS, stick with the "DORINFO1.DEF", as reports
  153.     say that DOOR.SYS may cause a problem, generating a Runtime Error 106)
  154.  
  155.  
  156. ╓───────────────────────────────────────────────────────────────────────────╖
  157. ║ GifSee - Common questions                                                 ║
  158. ╙───────────────────────────────────────────────────────────────────────────╜
  159.  
  160.     Q) How do I stop the graphics from displaying on my montior?
  161.     A) Use the GIFDESK=FILE setting before running GIFSEE
  162.  
  163.     Q) It makes the picture, but it looks all garbaled!
  164.     A) Use the GIFDESK=FILE setting before running GIFSEE, as your
  165.        monitor does not support 640x480x256 color mode.
  166.  
  167.     Q) The pictures it makes are small, but is there anyway to make
  168.        them even smaller?
  169.     A) Try using the GIFDESK=VGA mode if you don't mind the graphics
  170.        being displayed locally.  It will make a 640x480x16 color file
  171.        which is pretty small usually.  Refer to the GIFDESK.DOC file
  172.        for other modes you might want to try.
  173.  
  174.     Q) How much hard drive space does this take when running?
  175.     A) Well, due to what it's doing, sometimes quite a bit.  It copies
  176.        each file to a temporary directory, and then creates the new
  177.        file. This alone could be some amount if the user combines 8
  178.        300k files (2.4megs), the swapping routine may also need to use
  179.        hard disk space if not enough XMS or EMS is available (upto 450k
  180.        more) and if you are using the GIFDESK=FILE setting, another 768k
  181.        gets eaten up, so the maximum it might require is about 4 megs,
  182.        remember that this is temporary, and as soon as the user has
  183.        completed their download, it will be released.  With normal
  184.        circumstances, the usual amount of temporary space is around 1-2
  185.        megs.
  186.  
  187.     Q) I have less than 12,000 files, but not all of them are being
  188.        displayed.
  189.     A) Either you haven't registered it :) or you have run out of memory.
  190.  
  191.     Q) Can I change the help file that GifSee displays?
  192.     A) Yes, make your own text file called GIFSEE.HLP and it will be
  193.        displayed instead of the original hardcoded one.
  194.  
  195.     Q) How much memory does GifSee need?
  196.     A) It really is dependant on how many files you have. If you have a
  197.        small GIF file collection, probably around 220k will be enough.
  198.        However, if you have 12,000 files, you will probably need about
  199.        300k to run successfully. If you experience problems, try to
  200.        increase the memory.  Personally, on my system, I run with about
  201.        400k free in the window.
  202.  
  203.     Q) Why copy them to a temporary drive?
  204.     A) Because it takes about 10 times longer to read them from other
  205.        directories, expecially CDROM drives.
  206.  
  207.     Q) What are precompiled lists? Should I use them? and how do I make them?
  208.     A) A precompiled list is simply a data file that is made with the
  209.        program COMPILE included in the package.  It scans your drive
  210.        you enter and creates a compiled data list.  Then if you use this
  211.        datafile in the configuration (using type * command), then instead
  212.        of scanning your drive again, all it needs to do is read this file.
  213.        It is suggested that you do this if you have many CDROM drives, and
  214.        only do it on the CDROM drives, as files cannot be moved/deleted
  215.        from them.  If you do it on your hard drive, it will work, but if
  216.        you edit, delete or move any of the files that are in the list, you
  217.        will need to recompile that directory again.
  218.  
  219.     Q) Does it respect my BBS's security levels for file areas?
  220.     A) No, I want it to be flexible and able to be used with any BBS
  221.        system.  It is up to you to make menu options that pass an
  222.        appropriate configuration file to GifSee.
  223.  
  224.     Q) How do I restrict certain users from certain areas?
  225.     A) You will have to make multiple configuration files that
  226.        will configure the correct file areas for each security
  227.        level.  For example, if you have two types of users, say
  228.        Minor and Adult, then you could have two config files, and
  229.        in your menu options, you would make two options, the first
  230.        would be available to the adult user, and the second to the
  231.        minor user.  The menu would call GifSee and pass it an
  232.        appropriate configuration file.
  233.  
  234.     Q) What if I have more than 30 areas?
  235.     A) Bascially use the same method as above, except instead of
  236.        user security levels, you might have it divided into
  237.        library configuration files.  GifSee is very flexible in
  238.        the way it's design is implemented.
  239.  
  240.     Q) Will GifSee in the future support BBS package security levels?
  241.     A) Not likely, due to the fact that there are toooo many
  242.        different packages.
  243.  
  244.     Q) How do I stop that damn beeping sound?
  245.     A) Run the NOBEEP program once, that will stop it forever.
  246.        To return sound, simply rename the .OLD file back to an .EXE
  247.  
  248.     Q) Does this work with multinode?
  249.     A) Yes.
  250.  
  251.     Q) Can I change the GIFSEE.GIF file?
  252.     A) When you register, you can replace the GIFSEE.GIF picture with
  253.        any GIF of your own.  (For example, a BBS Advertisment, or
  254.        whatever else you wish)
  255.  
  256.     Q) Is this program only $7.00 for real?
  257.     A) Yes, so please register, hey it's real cheap!
  258.  
  259.  
  260. ╓───────────────────────────────────────────────────────────────────────────╖
  261. ║ GifSee - Common error codes                                               ║
  262. ╙───────────────────────────────────────────────────────────────────────────╜
  263.  
  264.            1-1: Not enough memory to swap
  265.   4-0 to 6-255: Error swapping
  266.  
  267.            2-0: File not found
  268.     2-1 to 2-4: Bad path
  269.            2-5: Path too long
  270.            2-6: Drive not ready
  271.  
  272.            3-2: File not found
  273.            3-3: Path not found
  274.            3-5: Access denied
  275.           3-10: Out of memory
  276.  
  277.      If you cannot resolve an error, then please forward the error code
  278.      as well as a description of what it was doing at the time of error
  279.      and a copy of your CFG, recent LOG and BAT file to my Fido address
  280.      1:2401/123 or call me data at (519)660-8981  [1200-14400]
  281.  
  282.  
  283. ╓───────────────────────────────────────────────────────────────────────────╖
  284. ║ License and Disclaimer                                                    ║
  285. ╙───────────────────────────────────────────────────────────────────────────╜
  286.  
  287.     GifSee is not free,   it is being marketed under the "try before you
  288.     buy" or  shareware concept.  You are  entitled to  use GifSee  for a
  289.     period up to thirty (30) days, after which you MUST register it.
  290.  
  291.     Registration entitles you to use  this version of  GifSee as well as
  292.     any future versions of the programs that may or may not be released.
  293.  
  294.     By running any of the  executable programs included,  you agree that
  295.     Pete Rocca,  nor any affiliates  of Pete Rocca  are  responsible for
  296.     any damage ever experienced, however so created. If you cannot agree
  297.     to this, then your privilege to use any of these programs is revoked
  298.     and it becomes illegal for you to execute any programs included with
  299.     this documentation.
  300.  
  301.     You may freely copy and  distribute the  shareware version of GifSee
  302.     as long as its original archived  contents  are not  modified in any
  303.     way.  You  may not use nor distribute a registration key without the
  304.     written consent of Pete Rocca of Multiboard Communications Centre.
  305.  
  306.     It is illegal to hack, reverse engineer and/or modify any components
  307.     of the GifSee archive.  If you  agree to all  of the above, then you
  308.     may use this program.
  309.  
  310.  
  311. ╓───────────────────────────────────────────────────────────────────────────╖
  312. ║ Registration                                                              ║
  313. ╙───────────────────────────────────────────────────────────────────────────╜
  314.  
  315.                Please see the enclosed registration forms.
  316.  
  317.              REGISTER.CAN - For registration from in Canada
  318.              REGISTER.EUR - For registration from in Europe
  319.              REGISTER.FRM - For registration from anywhere else
  320.  
  321.  
  322. ╓───────────────────────────────────────────────────────────────────────────╖
  323. ║ Support, Comments                                                         ║
  324. ╙───────────────────────────────────────────────────────────────────────────╜
  325.  
  326.     If you have any questions or comments,  you  can  Netmail me  at the
  327.     FidoNet (1:2401/123) XA,CM,V32,V42.  Registered users will get their
  328.     replies sent out direct, however,unregistered users will either have
  329.     to poll my system for responses, or request I route the message back
  330.     to you. (Sorry, but I have to keep costs down)  You can also find me
  331.     in the RemoteAccess Utilities FidoNet area.   The latest version can
  332.     always be FREQ'd with the magic name "GIFSEE".
  333.  
  334.  
  335.    Current Support Sites
  336.    ─────────────────────────────────────────────────────────────────────
  337.  
  338.    CANADA
  339.  
  340.       Southern Ontario
  341.  
  342.          Pete Rocca                       RemoteAccess 2.01+
  343.          Multiboard Communications        DESQview 2.62
  344.          London, ON                       PCL 14,400
  345.          (519)660-8981                    Worldwide Registration Site
  346.          Fidonet 1:2401/123
  347.  
  348.  
  349.  
  350.    UNITED STATES
  351.  
  352.       Wisconsin
  353.  
  354.           Scott Hansen                    RemoteAccess 2.01/Pro+
  355.           Ye Olde Pawn Shoppe ]I[         DESQview 2.62
  356.           Milwaukee, WI                   HST16, VFC
  357.           (414)649-9361
  358.           Fidonet 1:154/750
  359.  
  360.  
  361.       Missouri
  362.  
  363.          Tom Stoltz                       RemoteAccess 2.01/Pro+
  364.          Happy Hour RA                    HST DualStandard
  365.          Raymore, MO
  366.          (816)322-1133
  367.          Fidonet 1:280/301
  368.  
  369.  
  370.  
  371.    EUROPE
  372.  
  373.       Germany
  374.  
  375.          David Silver                     ProBoard Beta Site+
  376.          Silverado                        ZYXEL 28,800
  377.          Heidelberg                       European Registration Site
  378.          49-6221-767992
  379.          Fidonet 2:2468/6018
  380.  
  381.  
  382.  
  383. ╓───────────────────────────────────────────────────────────────────────────╖
  384. ║ Acknowledgments                                                           ║
  385. ╙───────────────────────────────────────────────────────────────────────────╜
  386.  
  387.     This program  is tested on Dos 3.3 upto Dos 6.2, DesqView 2.40  thru
  388.     2.62, DV/X 1.2 thru 2.0, Windows 3.1, WinOS/2 and OS/2 2.0 thru 2.11
  389.     Other enviroments should be fine, but they have not been tested yet.
  390.  
  391.     GifDesk(tm) is  a copyrighted piece of freeware,  being  distributed
  392.     with GifSee as legally stipulated in the GifDesk documentation.  GIF
  393.     is a registered trademark of CompuServe.
  394.  
  395.     Thanks to my wife Laurie, who hates me being on 'this damn machine',
  396.     but still finds the way to support me.  Thank you.
  397.  
  398.     Thanks to you,  the user,  for actually reading to  the  end of the
  399.     documentation, congratulations, and remember, please register.
  400.  
  401.                                     ---
  402.  
  403.                     Documentation End / June 22nd, 1994
  404.